Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Formatting for Specific Devices

GXGetPreferredJobFormatMode

You can use the GXGetPreferredJobFormatMode function to obtain the preferred mode of printing to the printer associated with a print job.

gxJobFormatMode GXGetPreferredJobFormatMode (gxJob aJob,
                                          Boolean *directOnly);

aJob

A reference to the job whose format mode you wish to determine.

directOnly

A pointer to a Boolean value returned by this function that specifies whether the preferred mode is the only mode.

function result

The preferred mode.

DESCRIPTION

The GXGetPreferredJobFormatMode function returns the preferred mode of printing to the job's output printer. The preferred mode is one of the modes proposed by the application in a call to GXSetAvailableJobFormatModes. From that information, the printer driver can respond with its preferred mode.

The preferred mode is typically a mode supported directly by the driver's hardware. In the case of an ImageWriter II, the GXGetPreferredJobFormatMode function returns gxTextJobFormatMode because it can use fonts built into the printer itself for faster text printing. The preferred mode typically represents the job format mode with the fastest throughput; however, it may limit the quality or even the kind of output that may be printed.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

For more information about how to use this function, see "Implementing Direct-Mode Printing" on page 4-35.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help